home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / a_utils / _archvrs / amiga / arc021.arc / amigarcd.021 < prev   
Text File  |  1987-01-30  |  5KB  |  147 lines
  1. AmigArc - Archive utility, Version 0.21, created on 01/30/87 at 19:38
  2.  
  3. Compatible with ARC v5.0
  4.  
  5. (C) COPYRIGHT 1986,87 by Raymond S. Brand; ALL RIGHTS RESERVED
  6. (C) COPYRIGHT 1985,86 by System Enhancement Associates; ALL RIGHTS RESERVED
  7.  
  8. Please refer all comments/inquiries/contributions to:
  9.  
  10.    US Snail:
  11.          Raymond S. Brand
  12.          503 Rowland Road
  13.          Fairfield Ct. 06430
  14.  
  15.    Modem:
  16.          Brand X Fido/SEAdog (141/255)
  17.          (203) 255-7729
  18.          300/1200/2400
  19.  
  20. Hello,
  21.    AmigArc v0.21 is a version of ARC v5.0 ported to the Amiga. As such, it
  22. can perform all of the normal ARC commands on '.ARC' files (for information
  23. on ARC commands, find a copy of ARC.DOC).
  24.  
  25. Changes for version 0.21:
  26.    1) No noteworthy (none were reported!) bugs were fixed in this release
  27.       and some of the code was cleaned up, and error reports now go to
  28.       stderr instead of stdout.
  29.    2) Control C is now supported (but could be better).
  30.    3) This version was compiled using Lattice 3.10 which found some dormant
  31.       bugs, and should be a little faster.
  32.    4) File dates are now set when a file is extracted.
  33.  
  34. Known bugs remaining:
  35.    1) The NOT operator for wild card matching does not always work. The fix
  36.       looks to be a major rewrite of the WCmatch routines (sigh...).
  37.  
  38. Items of Note:
  39.    1) The Run command will NOT be supported.
  40.  
  41.    2) The current version uses the MSdos '.ARC' file structure. This means
  42.       that file names should follow MSdos conventions. The next version will
  43.       be able to use the full AmigaDos filenames, and will have an MSdos
  44.       compatibility option.
  45.  
  46.    3) Wild Cards are permitted in the filename portion of the template, but
  47.       NOT in the path. The Wild Card scheme used is:
  48.  
  49. /*
  50.  * WCmatch: Function to determine if the first string matches
  51.  *    the template in the second string. If the third parameter
  52.  *    is zero then case does NOT matter.
  53.  *
  54.  *    Returns:
  55.  *       1 if string matches template.
  56.  *       0 if string does NOT match template.
  57.  *       Any other value indicates a template syntax error.
  58.  *
  59.  *    19860308 Raymond S. Brand
  60.  *
  61.  *    Version 0.08
  62.  *
  63.  *    The following describes the syntax of a valid template.
  64.  *       Items in braces ('{' and '}') may be repeated zero or more times.
  65.  * 
  66.  * <template>  := <AGroup>
  67.  * 
  68.  * <AGroup>    := <PGroup>{&<PGroup>}  'AND'
  69.  *
  70.  * <PGroup>    := <LGroup>{|<LGroup>}  'OR'
  71.  *
  72.  * <Group>     := <LGroup>{|<LGroup>}  'or'
  73.  * 
  74.  * <LGroup>    := <SGroup>{<SGroup>}   'Match-String'
  75.  * 
  76.  * <SGroup>    := (<Group>)            'grouping'
  77.  *             := %                    'End-of-Name'
  78.  *             := ^<SGroup>            'NOT'
  79.  *             := <Literal1>
  80.  *             := ?                    'Any-Character'
  81.  *             := #<SGroup><MGroup>    'Zero-or-More Followed-By'
  82.  *             := *<MGroup>            'Zero-or-More-of-Any-Character'
  83.  *             := [<EnumList>]         'Enumeration-List'
  84.  * 
  85.  * <MGroup>    := <LGroup>
  86.  *             :=
  87.  *
  88.  * <EnumList>  := <EnumPart>{,<EnumPart>}
  89.  *
  90.  * <EnumPart>  := <Literal2>
  91.  *             := <Literal2>-<Literal2>   'All-Characters-From To'
  92.  * 
  93.  * <Literal1>  := <any printing character except:
  94.  *                   '#', '%', '^', '&', '*', '(', ')', '|', '\', '[',
  95.  *                   ']' and '?'>
  96.  *             := \<any printing character including the above>
  97.  * 
  98.  * <Literal2>  := <any printing character except:
  99.  *                   '\', '[', ']', '-' and ','>
  100.  *             := \<any printing character including the above>
  101.  *
  102.  *
  103.  *    NOTES:
  104.  *       The 'AND' and the 'OR' functions have an implicit 'End-of-Name'
  105.  *          function before their respective operators.
  106.  *       The 'or' function moves the internal name pointer just past the
  107.  *          first match that it finds.
  108.  *       The second form of <EnumPart> matches the current name character
  109.  *          if the first literal is less than or equal to the current name
  110.  *          character, and the current name character is less than or equal
  111.  *          to the second literal. Or if the first literal is less than the
  112.  *          current name character, or the current name character is less
  113.  *          than the second literal when the first literal is greater than
  114.  *          the second literal. An <EnumPart> will never match the name
  115.  *          terminator. e.g. 'a-f' will match 'a', 'b', 'c', 'd', 'e' and
  116.  *          'f'; Whereas, 'f-a' will match all characters except 'a', 'b',
  117.  *          'c', 'd', 'e' and 'f'.
  118.  *       The '*' operator is equivalent to '#?'.
  119.  */ 
  120.  
  121.    4) If you experience a problem or bug in the program, please send
  122.       a message describing what you were doing and what happened (be
  123.       specific) at:
  124.  
  125.          Brand X Fido/SEAdog (141/255)
  126.          (203) 255-7729
  127.  
  128.    5) Do NOT bother System Enhancement Associates about this program. They
  129.       have little to do with the Amiga version of ARC.
  130.  
  131.    6) Suggestions, comments, criticisms, etc. are welcome and encouraged.
  132.  
  133.    7) This version of AmigArc does not have a "timeout" but please try to
  134.       always use the latest version available.
  135.  
  136.    8) For the latest version of AmigArc check Brand X Fido or Amuse.
  137.  
  138.    9) To speed compression, ASSIGN ARCTEMP: RAM:
  139.  
  140.   10) The correct file size for AmigArc.021 is 50252 bytes.
  141.  
  142.  
  143.  
  144.                                  Raymond S. Brand
  145.                                       RSBX
  146.  
  147.